home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 326-350 / disk_334 / ppshow / ppshow.doc < prev    next >
Text File  |  1992-05-06  |  6KB  |  156 lines
  1.  
  2.  
  3.                            PPShow 1.0 User Manual
  4.  
  5.                                  Jan 1, 1990
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.      This program is freeware, this means that you can copy it freely as long
  13. as you don't ask any more money for it than a nominal fee for copying.  If
  14. you want to distribute this program you should keep this document with it.
  15.      If you have suggestions or remarks about this program, or if you find
  16. any bugs, please let me know.
  17.  
  18.      Write to the following address:
  19.  
  20.                                 Nico François
  21.                                 Corbielaan 13
  22.                              3060 Bertem BELGIUM
  23.  
  24.  
  25. Contents
  26. ========
  27.  
  28. 1. An introduction
  29.  
  30. 2. Usage
  31.  
  32. 3. Features
  33.  
  34. 4. Note on crunching
  35.  
  36.  
  37. 1. An introduction
  38. ==================
  39.  
  40.      PPShow was written to complement one of my other utilities, PowerPacker
  41. (a command and data cruncher).  It is used to show normal IFF ILBM files or
  42. ILBM files crunched with PowerPacker.  The decrunching is done automatically
  43. so the user doesn't have to know if a file is crunched or not.
  44.      If you haven't got PowerPacker you are of course missing one of the main
  45. features of this program.  You can try to find it in your favourite public
  46. domain library or you can get it by writing to my address and adding $15 US
  47. (if you live in Europe), $20 US (if you live elsewhere).  Send money in cash,
  48. by international money order or by EuroCheck (only in Belgian Francs (BF) !!)
  49. (Please don't send other checks).  PowerPacker was published in the November
  50. 89 issue of JumpDisk and can be found on one of the Antares RD or Fish disks
  51. as well as on several other PD disks.
  52.  
  53.  
  54. 2. Usage
  55. ========
  56.  
  57.      PPShow can be used in three different ways.
  58.  
  59. - First of all via the CLI:
  60.  
  61.      If you enter PPShow without arguments you will get a usage template.
  62. You use PPShow like this:
  63.  
  64.      PPShow [<options>] <filename>
  65.  
  66.      The program will then load the ILBM file and display it.  If the file
  67. was crunched using PowerPacker 2.0 or higher PPShow will first decrunch it
  68. for you.  If the file was encrypted you will be prompted for the password.
  69.      There is only one option in this version: '-h'.  This option is used to
  70. force HAM mode when no CAMG chunk is found.  If you don't specify this option
  71. PPShow will assume a 6 plane screen is extra half brite. (Note that it is
  72. wrong for an Amiga IFF ILBM file not to have a CAMG chunk, especially when
  73. there can be doubt about what display mode to pick !)
  74.      PPShow can be made resident so it doesn't have to be loaded every time
  75. you use it, use the ARP ARes command or the WB1.3 Resident command for this.
  76. You can't make PPShow resident when it is crunched !!  The file is supplied
  77. as an uncrunched command file with the pure bit set.  PPShow is reentrant as
  78. well, so you can run it from several CLI's at the same time. (Not that this
  79. is very useful, but it's possible :-D)
  80.  
  81.      Example:       '1> PPShow -h dh0:pics/HAMpicWithoutCAMG.pic'
  82.  
  83. - Via the WorkBench:
  84.  
  85.      There are three different ways of using PPShow via the workbench: you
  86. can set the default tool of the (crunched) ILBM file to 'PPShow', you can
  87. single click the PPShow icon and then double click the picture icon or you
  88. can double-click the PPShow icon and enter the filename in the string gadget
  89. you will be presented with.
  90.      You set the default tool by single clicking the icon of the picture
  91. and selecting 'Info' from the workbench menu.  You will get a window with
  92. several gadgets in it, click in the string gadget where it says 'Default
  93. tool' and enter ':ppshow'.  PPShow should be in the root directory of your
  94. disk for this to work, if e.g. it's in the system directory you should enter
  95. ':system/ppshow'.  Last of all select the 'Save' gadget.
  96.  
  97. NOTE: - PPShow will add '.pp' to the filename when the file wasn't found.
  98.         This is very useful in the WorkBench enviroment: you can make an
  99.         icon for 'house.pic' but name the file 'house.pic.pp'.  Now the
  100.         WorkBench will show an icon with 'house.pic' as name, but if you
  101.         doubleclick it 'house.pic.pp' will be displayed. (As long as there
  102.         is no 'house.pic' file in the directory !)
  103.  
  104. 3. Features
  105. ===========
  106.  
  107.    -   Abort PPShow by pressing any key (except <TAB> or 'P') or the right
  108.      mouse button.  The screen can be dragged by an invisible drag bar at
  109.      the top.
  110.  
  111.    -   The pesky little mouse will be removed while displaying.
  112.  
  113.    -   PPShow offers full overscan support, PAL or NTSC.  As far as I know
  114.      this is the first ILBM viewing program to do so, looks like PAL Amiga
  115.      owners still get forgotten.  All Amiga display modes (like HAM, EHB)
  116.      are of course also supported.
  117.  
  118.    -   Deluxe Paint cycling is supported, press <TAB> to (de)activate.  Up to
  119.      8 cycles are supported (DPaint III currently only supports 6).
  120.  
  121.    -   PPShow has the ability to print the screen it is displaying, all you
  122.      have to do is press 'P' on the keyboard and wait.  The mouse pointer
  123.      will be visible while printing.  Please note that the printer.device has
  124.      to be in the 'devs:' directory for PPShow to be able to print, you
  125.      should also have a correct system-configuration for your printer.
  126.  
  127. 4. Note on crunching
  128. ====================
  129.  
  130.      A lot of IFF ILBM files are already crunched with the standard ByteRun1
  131. compression.  PowerPacker will crunch these files even further (most of the
  132. time) but will not crunch them as well as uncrunched ILBM files.  So save IFF
  133. files uncrunched (if you can, e.g. with PixMate) before crunching them, this
  134. way you will get the best crunching results.
  135.  
  136.  
  137.                       As always, I hope you find this program useful !
  138.  
  139.  
  140.                               PROGRAM HISTORY:
  141.  
  142. *****************************************************************************
  143. VERSION 1.0
  144.  
  145.      First release.
  146.  
  147. *****************************************************************************
  148.  
  149. PPShow 1.0 written by Nico François (Yes, Nico is my first name :-)
  150.  
  151. (c) 1989 Nico François / PowerPeak
  152.  
  153.                                    //
  154.                        Thanks to \X/ Amiga for being the best computer ever !
  155.  
  156.